HTML TEXT CONVERTER =================== Oui, je sais, personne ne lit les docs, mais je tenais quand mˆme … en faire une parce qu'on ne sait jamais... 8-) *********************************** SOMMAIRE *********************************** 1. Quoi que c'est ? Quoi qu'il fait ? 1.1. Rapide description 1.2. Comment s'en servir 2. Remarques 2.1. Les fichiers HTML g‚n‚r‚s 2.2. Les caractŠres convertis 3. Les versions pass‚es et … venir 4. Bugs ? 5. Contact et copyright ******************************************************************************** 1. Quoi que c'est ? Quoi qu'il fait ? ===================================== HTML TEXT CONVERTER en est … sa version 1.5. Cet utilitaire a ‚t‚ entiŠrement programm‚ en GFA Basic 3 (euh... ‡a se voit ?). 1.1. Rapide description ----------------------- Bon, je ne vais pas vous faire l'insulte de vous pr‚senter le langage HTML, de toutes fa‡ons si vous ne savez pas ce que c'est, c'est que vous n'en avez pas besoin. Allez hop, circulez ! HTML TEXT CONVERTER sert … faire deux choses : - il sert … convertir un texte ASCII en HTML avec l'en-tˆte, les sauts de ligne et tout et tout, - il sert … convertir les accents ASCII en accents HTML, de mˆme que tous les caractŠres sp‚ciaux. Je l'ai programm‚ pour m'aider … composer mes pages HTML … partir de documents ASCII. Pour ne rien vous cacher, je m'en suis servi pour convertir le Toxic Mag en version HTML (ce diskmag est gratuit, d'ailleurs, envoyez-moi une disquette et des timbres pour recevoir le tout dernier num‚ro). 1.2. Comment s'en servir ------------------------ DŠs le lancement du logiciel, vous aterrissez sur un formulaire qui vous offre 5 possibilit‚s : - Convertir depuis un texte ASCII : HTML TEXT CONVERTER va s'amuser … triturer votre texte afin de le transformer partiellement au format HTML. Cette conversion n'‚tant pas parfaite, il est toujours conseill‚ de repasser derriŠre avec un ‚diteur de texte. Reportez-vous … la section 2 pour avoir des infos sur le type de fichier g‚n‚r‚. A noter que les caractŠres ">", "<" et "&" sont convertis ici. - Ne convertir que les caractŠres : dans ce cas, HTML TEXT CONVERTER va traduire vos accents classiques en accents HTML. Ex : "‚" va devenir "é" et "—" va devenir "ù". L'int‚rˆt de cette option est qu'elle permet par exemple de faire la chasse aux accents ASCII sur une page HTML. En pratique, on se servira plut“t de la premiŠre option. A part les accents, … peu prŠs tous les caractŠres dont le code ASCII d‚passe 127 sont convertis (pour plus d'informations, voir la partie "2.2"). A noter qu'ici on ne convertit pas les ">", les "<" et les "&". - Options : ces options s'appliquent en g‚n‚ral aux deux types de conversion : - Mode ‚num‚ration : si une ligne de votre fichier ASCII commence par un tiret (-) et que cette option est activ‚e, le logiciel va penser qu'il s'agit d'une liste et va donc ajouter un saut de ligne … la fin (
). Attention, cela ne concerne que l'option "Convertir depuis un texte ASCII". - Conversion des accents : je vous conseille de toujours laisser cette option activ‚e... trŠs utile ! - Conversion des caractŠres sp‚ciaux : remplace la plupart des caractŠres dont le code ASCII d‚passe 127 par leur ‚quivalent en HTML. Si votre texte ASCII n'en comporte pas, d‚sactivez cette option car elle tend … ralentir la machine. - Conversion des "&" : permet de remplacer les "&" par des "&". Attention … ne pas utiliser cette option sur un fichier d‚j… converti en HTML ! - Conversion des "<" et des ">" : permet de remplacer les "<" et les ">" par des "<" et des ">". N'utilisez pas non plus cette option sur un texte d‚j… converti au format HTML ! - Conversion des guillemets : les guillemets sont remplac‚s par des """. - Infos : ben des infos sur le soft, tiens ! - Quitter : ... 2. Remarques ============ 2.1. Les fichiers HTML g‚n‚r‚s ------------------------------ HTML TEXT CONVERTER se contente d'ajouter des modifications au fichier ASCII d'origine, ce qu'il fait que la taille d'un fichier HTML ainsi obtenu sera TOUJOURS plus grande que celle du fichier de d‚part. Voyons en d‚tail ce que contient le fichier HTML issu de la conversion : HTML TEXT CONVERTER commence tout d'abord par une remarque (qui ne sera donc pas prise en compte par votre browser HTML favori) et indique que c'est lui qui a converti votre fichier. Il ajoute le nom de l'auteur (coucou c'est moi !) ainsi que la date et l'heure de la conversion (‡a peut ˆtre utile). Il ajoute ensuite l'en-tˆte traditionnelle : (...) N'oubliez pas de mettre votre titre en passant. Si le logiciel repŠre une ligne vide, il met ceci … la place :

Autrement dit, on saute une ligne et on commence un nouveau paragraphe... Enfin, HTML TEXT CONVERTER ajoute ceci … la fin du texte HTML : Les amateurs du langage HTML appr‚cieront... 8-) 2.2. Les caractŠres convertis ----------------------------- Voici la liste des caractŠres convertis : tout d'abord les accents, ensuite les caractŠres "sp‚ciaux". Accents convertis : A : …, ¶, †, ,  , ƒ, „, Ž, °, ·, ‘, ’. E : ‚, , Š, ˆ, ‰. I : Œ, ‹, ¡, . O : “, ”, ™, ¢, •, ±, ¸, ², ³. U : –, , š, £, —. Y : ˜. C‚dilles : ‡, €. Tildes : ~, ¤, ¥. CaractŠres sp‚ciaux convertis : ­, ›, œ, , |, Ý, ¹, ½, ¾, ®, ¯, ¦, ª, ÿ, ø, ñ, ý, þ, º, æ, ¼, ú, §, ¬, «, ¨, ö, ž. Certains caractŠres sp‚cifiques … l'Atari ne sont pas reconnus par le langage HTML. J'ai d– me d‚brouiller avec les moyens du bord : ´ -> oe µ -> OE Ÿ -> f ¿ -> (TM) À -> ij Á -> IJ Þ -> ^ D'autres caractŠres (symboles math‚matiques, lettres h‚bra‹ques et grecques) n'ont pas d'‚quivalent en HTML. Les caractŠres "&", "<" et ">" ne sont remplac‚s que si l'on convertit un texte ASCII en HTML et non pas si l'on ne veut remplacer que les caractŠres dans des pages HTML d‚j… existantes. Ce qui est normal dans la mesure o— le langage HTML use et abuse de ces caractŠres. 3. Les versions pass‚es et … venir ================================== Version 1.0 du 4 avril 1997 : - Interface crade un peu repoussante... - Ne reconnaŒt pas les fin de fichiers (bref : du boulot bƒcl‚, arf !) Version 1.1 du 5 avril 1997 : - Les fins de fichiers sont reconnus (ouf) - Accents fran‡ais seulement Version 1.2 du 10 avril 1997 : - La boŒte de dialogue a ‚t‚ chang‚e (il y a un fichier RSC maintenant) - Encore plus d'accents reconnus - Et tout ‡a en quelques heures : yo ! Vive le GEM en GFA ! ;-) Version 1.3 du 15 avril 1997 : - Les caractŠres "½","&", "<" et ">" sont reconnus - Pratiquement tous les accents sont reconnus - Un bug de l'interface a ‚t‚ corrig‚ (la boŒte de dialogue ‚tait s‚lectionable) Version 1.4 du 8 mai 1997 : - Le logiciel se souvient du dernier chemin - Dans les commentaires, les "" ont ‚t‚ remplac‚s par "" Version 1.5 du 30 mai 1997 : - Absolument tous les accents sont reconnus - Ainsi que pas mal de caractŠres dont le code ASCII est sup‚rieur … 127 - L'option "Ne convertit que les accents" a ‚t‚ remplac‚e par "Ne convertit que les caractŠres" - Nouvelles options (voir dans la partie 1.2) - Ces options se sauvegardent automatiquement dŠs que l'on quitte le logiciel - Fonctionne dans toutes les r‚solutions du ST et du Falcon Am‚liorations futures : - Conversion des lettres grecques ? 4. Bugs ? ========= - Il vaut mieux que les fichiers source et destination ne soient pas les mˆmes et qu'ils ne soient pas sur deux disquettes diff‚rentes car figurez-vous que HTML TEXT CONVERTER ouvre les deux fichiers en mˆme temps (pour bouffer le moins de RAM possible et parce que c'est plus facile … programmer, ben tiens !). - La derniŠre ligne du texte ASCII … convertir doit ˆtre vide et NE DOIT PAS comporter un seul caractŠre, sinon soit le GFA met "Error 26" (fin de fichier atteinte), soit il balance 2 bombes mais sans bloquer la machine (encore heureux). - HTML TEXT CONVERTER a ‚t‚ programm‚ et test‚ sur Falcon 030 et il devrait normalement tourner avec TOUS les cl“nes Atari de la planŠte. Si ce n'est pas le cas, contactez-moi SVP. - Sous MagiC, lancez ce programme en mode monotƒche de pr‚f‚rence (ou bien en mode multitƒches, pourvu qu'il n'y ait aucune autre fenˆtre en dessous). - Contactez-moi aussi si vous trouvez d'autres bugs... 8^) 5. Contact et copyright ======================= HTML TEXT CONVERTER est postcardware. En clair et sans d‚codeur, vous DEVEZ m'envoyer une belle carte postale si vous remplissez au moins l'une des conditions suivantes : - si vous avez aim‚ le soft - si vous l'utilisez souvent - si vous l'avez install‚ sur votre disque dur (amovible ou fixe) ou un CD-Rom. Ca va me permettre de savoir si quelqu'un d'autre que moi utilise mon soft. Parce que si je vois que je ne re‡ois pas de cartes postales, ‡a voudrait dire que personne ne l'utilise et je ne vois pas pourquoi je m'emmerderais … faire une interface GEM vu que je pourrais bien m'en passer ! Au fait, je ne pourrais pas m'amuser … r‚pondre … toutes les cartes postales (je ne travaille pas … La Poste) mais vous pouvez toujours me laisser votre pseudo sur RTEL ou bien votre adresse e-mail ! Contactez-moi … l'adresse suivante : PEREZ St‚phane 328, Les Hauts du Louvarou 38560 HAUTE-JARRIE Sur Internet : sperez@club-internet.fr (avant Juillet 97) Ou bien sur minitel : 3615 RTEL1 bal THE BEAST 3615 STMAG bal TYPHOON 3614 TEASER bal TYPHOON Vous trouverez avec le programme un fichier FILE_ID.DIZ ainsi que la doc anglaise. Bonne journ‚e (nuit ?) !!!